home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
usa11.zip
/
USA.DOC
< prev
next >
Wrap
Text File
|
1992-01-05
|
11KB
|
272 lines
USA DOOR
V.1.0
Release Version 1.0
Copyright (c) 1991 Gary R. Smith
All Rights Reserved
DISCLAIMER
There is made no warranty of any kind, express or implied,
including without limitation, any warranties of merchantability
and/or fitness for a particular purpose. I shall not be liable
for any damages, whether direct, indirect, special or on
sequential arising from a failure of this program to operate in
the manner desired by the user. I shall not be liable for any
damage to data or property which may be caused directly or
indirectly by the use of this program.
IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING
ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR
CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE
THE PROGRAM, OR FOR ANY CLAIM BY ANY OTHER PARTY.
If you would like to keep the latest version of the USA DOOR on
your system, you can download the latest version from one of our
Support Boards or your favorite Quality BBS System.
Random Access, (Computer Profile's Support Board)
Marietta, Georgia
(404) 516-7150 (14.4 HST)
What it does - The USA door will allow your users to view the
USA TODAY news online. This door breaks the newspaper down into
a systematic way so that it easier to get to each section of the
paper. The USA DOOR gives your board a look and feel of excellence
and sophistication. Give it a try and see it doesnt make your
reading of the morning paper that much easier and enjoyable.
------- Required for operation (USATODAY.ZIP)
Features of USA Door:
o Works with most door formats including PCBoard.sys, Door.sys
sfdoors.dat etc...
o Displays in color / non - color modes!
o Detects Loss of carrier!
o Can operate at speeds in excess of 115000 Baud!
o Will automatically log user off after 3 minutes of no keyboard
activity!
o Can be operated on a Multi-Networked Board!
o Written completely in Borland C++!
Getting Started:
Setting up USA is a very simple process. If you have set
up other doors then you will have no problems. Computer Profile
doors follow the system standards as setforth by PCBoard.
STEP BY STEP
------------
SETTING IT UP - (This example sets up a Single Node PCBoard 14.5 setup. If
you are running a different type of BBS software, set the door up according
to your BBS specifications. It should be very similiar to this example)
/*------------------------------------------------------------------------
Step 1: (Creating a directory)
Create a directory from which USA will run from.
This Directory can be called anything you wish that is
within the DOS 8 character limit. (This document will
assume you have selected C:\PCB\DOORS\USA for the remainder
of the examples).
/*------------------------------------------------------------------------
Step 2: (Copy the files)
Copy or UNZIP all the USA files into the directory you
just created above.
ex. COPY USA1.ZIP C:\PCB\DOORS\USA
PKUNZIP USA1.ZIP
/*------------------------------------------------------------------------
Step 3: (Create the Configuration file, USA.CNF)
Create the USA configuration file. This file will contain
all the external data that USA will use. Using your ascii
editor you will create a text file called "USA.CNF". The name
cannot be changed and it MUST be placed in your USA Directory.
If this file is not found a message is written to the screen
and the program is exited.
The below is a Description of each line required
Example - (USA.CNF)
Line 1 Random Access ( Bulletin Board Name)
Line 2 99999 ( Registration Number)
/*-------------------------------------------------------------------------
STEP 4: (Construct the batch file)
You now need to construct the batch file that PCBoard will use to
call the USA program. If your running multi-node you may
want to use the PCBoard enviornment variables provided by pcboard
14.5+.
By creating this batch file you are configuring it so USA will run
for that node. Each batch file you create should be like the
following example. (Assuming we are configuring for a single
Node)
USA - (PCBoard Version)
Line 1 @ECHO OFF
Line 2 CD C:\PCB\DOORS\USA
Line 3 USA C:\PCB\PCBOARD.SYS
Line 4 CD C:\PCB
Line 5 BOARD
USA - (PCBoard Multinode Version)
Line 1 @ECHO OFF
Line 2 CD C:\PCB\DOORS\USA
Line 3 USA.EXE %PCBDRIVE%PCBDIR%\PCBOARD.SYS
Line 4 CD %PCBDIR%
Line 5 BOARD
USA - (Other BBS Version)
Line 1 @ECHO OFF
Line 2 CD C:\BBSDIR\DOORS\USA
Line 3 USA C:\BBSDIR\DOOR.SYS
Line 4 CD C:\BBSDIR
Line 5 BBS COMMAND
Line 1 Turns off the Local Screen Echo (DOS 3.3 and up)
Line 2 Changes the directory to where USA is stored
Line 3 (1) USA Executable Statement
(2) The complete path to that nodes PCBoard.sys,
DOOR.sys, Generic.sys file
Line 4 Changes the directory back to the BBS directory
Line 5 Calls the PCBoard program / or your bbs program
NOTE: Your USA batch file should be similar to the example above,
Line 3 however, Must contain the path to the pcboard.sys
or door.sys type file.
* IMPORTANT *
This file is to be placed in the PCBoard or BBS directory.
/*------------------------------------------------------------------------
STEP 6: (Adding USA to the Doors File)
The next step to setting up is to add USA to your PCBoard
Doors file. This is done through the PCBoard setup program. All
you need to do once you are in the PCBSETUP editor for doors is
place the name of the batch file you just created above in a slot
for a door, give it a minimum security level and your all done.
/*------------------------------------------------------------------------
STEP 7: (Utilizing the USA Today Zip files)
In order for USA to run properly it must be able to find the USA
Today files. You should do something like the following...This is
a part of an automated batch file.
cd c:\uploads
pkunzip -o USATODAY.ZIP C:\PCB\DOORS\USA
del usatoday.zip
.
.
continue with batch files.
You should always use the -O option of pkunzip. This will over
write all the old USA Today files already in your USA directory.
** ALL USATODAY FILES MUST BE IN YOUR USA DIRECTORY IN ORDER FOR
USA TO WORK PROPERLY.
/*------------------------------------------------------------------------
RUNNING USA
Just type USA from the command line and your off and running. There
is nothing hard about this door, and it will run with all bbs
types.
/*------------------------------------------------------------------------
For those of you that understand Ports and IRQ settings!
NOTE: If you need to specify a non-standard port address and IRQ,
then the syntax is PORT:AAAA:X where AAAA is the base address and X is the
IRQ. It doesn't matter whether PORT:AAAA:X is the third or foruth parameter
as long as it is the LAST parameter passed.
PORT is optional, and USA will default to standard addresses and irqs
if it not used based on the port number read from the BBS file.
USA will assume COM1 = 03F8 IRQ 4, COM2 = 02E8 IRQ3, COM3 = 03E8 IRQ4
and COM4 = 02E8 IRQ 3. If you have a different non-standard port address and
irq, you could then use the PORT cmd to change the defaults.
USA will also support the use of FOSSIL drivers. The syntax for a FOSSIL
driver is: PORT:F:P. The 'F' tells USA to use a Fossil driver for it's
communications. The 'P' following it tells it which port to use for
the Fossil. Example - PORT:F:1, tells USA to use a fossil driver for
port 1.
-----------------------------------------------------------------------------
The USA DOOR is Shareware. You are granted a TWO week trial period
in which you may evaluate USA. If you continue to utilize this
product you are required to register it with the author. If
you do not register USA within the required time frame allowed,
You are REQUIRED to remove it from your board in accordance with
the United States Copyright Laws governing the use of Pirated Software.
If you register your copy of USA, you will receive a
registration Number to place in your USA.CNF FILE. This
number can be mailed to you, or for faster use you can call
our support board and download it.
(See the registration file for more information.)
We accept MasterCard/Visa Registrations. See the REGISTER.DOC
file for mail in's or call our Support BBS and register online
for immediate satisfaction.
To register your copy of USA, Fill out the form Register.doc
and mail it along with $12.00 (U.S. FUNDS) to :
Gary R. Smith
5012 Olde Mill Drive
Marietta, Georgia, 30066
Make all checks payable to
"Gary R. Smith"
All checks must be drawn from U.S. Banks...No foreign currency
will be accepted. (This includes Canadian) Please include in the
Registration form, exactly how you would like your BBS name to
appear on the Closing Screen.